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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.301: Configuration Management (CM); Notification Integration Reference Point (IRP): Requirements 

32.302: Configuration Management (CM); Notification Integration Reference Point (IRP): 

Information Service (IS) 

32.303: Configuration Management (CM); Notification Integration Reference Point (IRP): Common 

Object Request Broker Architecture (CORBA) Solution Set (SS) 

32.305: Configuration Management (CM); Notification Integration Reference Point (IRP): extensible 

Markup Language (XML) definition 

32.307: Configuration Management (CM); Notification Integration Reference Point (IRP): Simple Object 

Access Protocol (SOAP) Solution Set (SS) 

The Itf-N interface is built up by a number of Integration Reference Points (IRPs) and a related Name Convention, 
which realise the functional capabilities over this interface. The basic structure of the IRPs is defined in 
3GPP TS 32.101 [5] and 3GPP TS 32.102 [6]. 

Network Elements (NEs) under management and element managers generate notifications of events about occurrences 
within the network. Different kinds of events carry different kinds of information. For instance a new alarm as specified 
in Alarm IRP: Information Service [1], is one possible kind of event, an object creation as specified in Basic CM IRP: 
Information Service [8] is another possible kind of event. 

Information of an event is carried in notification. An IRP Agent (typically an EM or a NE) emits notifications. 
IRPManager (typically a network management system) receives notifications. The purpose of Notification IRP is to 
define an interface through which an IRPManager can subscribe to IRP Agent for receiving notifications. 

This IRP bases its design on work captured in ITU-T Recommendation X.734 [2], OMG Notification Service [4]. The 
central design ideas are: 

• Separation of notification Consumers (IRPManagers) from Producers (IRP Agents); 
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• Notifications are sent to IRPManagers without the need for IRPManagers to periodically check for new 
notifications. 

Common characteristics related to notifications in all other IRPs are gathered in one IRP. 
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Scope 



The purpose of Notification IRP is to define an interface through which an IRPManager can subscribe to an IRP Agent 
for receiving notifications. The present document is the "Information Service" of Notification IRP. It defines, for the 
purpose of subscribing to an IRP Agent for receiving notifications, the information observable and controlled by 
management system's client and it also specifies the semantics of the interactions used to carry this information. It also 
defines the information common to all notifications which is called the notificationHeader. 

An IRP Agent supporting this IRP IS may emit one or multiple categories of notifications, such as alarms (as specified 
in Alarm IRP: Information Service [1]) and others. This IRP IS defines a mechanism that IRPManager can use to 
determine the categories of notifications supported by an IRP Agent. It also defines a mechanism (subscribe and 
unsubscribe operations) that IRPManager can use to specify the categories of notifications IRP Agent should emit to 
IRPManager during subscription. It also defines a mechanism (getSubscriptionlds operation) that IRPManager can use 
to check which categories of notifications it has subscribed to. IRPManager can set and change filter criteria applicable 
during the life-cycle of a subscription. IRPManager can also exercise flow-control on IRP Agent's emission of 
notifications (suspendSubscription and resumeSubscription operations). 

Using different managerReference, an IRPManager can subscribe several times. It will result in multiple subscriptions. 
As far as IRP Agent is concerned, notifications are sent to multiple "places". 

Using the same managerReference, an IRPManager can subscribe several times specifying different categories of 
notifications. 

This IRP IS does not specify information that is carried in some but not all notifications. That kind of information is 
specified in other IRP ISs involved. For example, perceivedSeverity is a piece of information specific for 
notifications carrying alarm information. This information is not defined in the present document but in Alarm IRP: 
Information Service [1]. 

How IRPManager discovers the IRP Agent's address or reference (so that IRPManager can invoke an operation) is 
outside the scope of the present document. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.1 1 1-2: "Telecommunication management; Fault Management; Part 2: Alarm 

Integration Reference Point (IRP): Information Service (IS)". 

[2] ITU-T Recommendation X.734 (1992): "Information technology - Open Systems Interconnection - 

Systems management: Event report management function". 

[3] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[4] OMG: "OMG Notification Service", http://www.omg.org/technologv/documents/ 

[5] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[6] 3GPP TS 32.102: "Telecommunication management; Architecture". 
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[7] 3GPP TS 32.301: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Requirements". 

[8] 3GPP TS 32.602: "Telecommunication management; Configuration Management (CM); Basic CM 

Integration Reference Point (IRP): Information Service (IS)". 

[9] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[10] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Service (IS)". 

[11] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Requirements". 

[12] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 



Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [5], 3GPP TS 32.102 [6] 
and 3GPP TS 32.301 [7] and the following apply: 

IRPAgent: See 3GPP TS 32.102 [6]. 

IRPManager: See 3GPP TS 32.102 [6]. 

event: it is an occurrence that is of significance to network operators, the NEs under surveillance and network 
management applications 

Events can indicate many types of network management information, such as network alarms, network configuration 
change information and network performance data. 

notification: it refers to the transport of information regarding events from event producer to consumer (receiver) 
In this IRP, notification is used to carry information about network events from IRPAgent to IRPManager. Producer 
sends notifications to consumers as soon as new events occur. Consumer does not need to check ("pull") for events. 

IRP: See 3GPP TS 32.102 [6]. 

notification category: The semantics and syntax of the notification category string are identical to that defined for "IRP 
document version number string", see 3GPP TS 32.311 [11] subclause 3.1. 

qualifiers: the meaning of qualifiers for operations, parameters and information attributes (whether they are 
Mandatory(M)/ Conditional(C)/ Optional(O)) defined in the present (Information Service) document is provided in 
3GPPTS 32.102 [6]. 

Moreover, qualifiers of information attributes, when those information attributes are re-used in other IRP ISs, obey to 
the following rule: Mandatory and Conditional qualifiers of information attributes shall always be the same in other 
IRPs ISs, Optional qualifiers of information attributes may be set to either Optional or Mandatory in the other IRP ISs. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CORBA Common Object Request Broker Architecture 

DN Distinguished Name 

EM Element Manager 

IOC Information Object Class 

IRP Integration Reference Point 

IS Information Service 
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NE 

NM 

NR 

NRM 

OMG 

SS 

UML 



Network Element 

Network Manager 

Network Resource 

Network Resource Model 

Object Management Group 

Solution Set 

Unified Modelling Language (OMG) 



4 System overview 

4.1 System Context 

The general definition of the System Context for the present IRP is found in 3GPP TS 32.150 [12] subclause 4.7. 
In addition, the set of related IRP(s) relevant to the present IRP is shown in figure 1 and figure 2. 




Figure 1 : System Context A 
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Figure 2: System Context B 



5 Information Object Classes 

5.1 Information entities imported and local labels 



Label reference 


Local label 


3GPP TS 32.622 [9], information object class, Top 


Top 


3GPP TS 32.312 [10], information object class, managedGenericIRP 


managedGenericIRP 


3GPP TS 32.622 [9], information object class, IRPAgent 


IRPAgent 
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5.2 Class Diagram 

5.2.1 Attributes and relationships 

This subclause depicts the set of lOCs that encapsulate information within the notification IRP. The intent is to identify 
the information required for the notification IRP implementation of its operations and notification emission. This 
subclause provides the overview of all information object classes in UML. Subsequent subclauses provides more 
detailed specification of various aspects of these information object classes. 



« Wormat ionObj ect Class » 
NotificationIRP 



<-theNotificationlRP 1 



relation-ntflRP-ntfSubscriber 



+theNt6ubscriber 



«lnformationObjectClass» 
NtfSubscriber 



ntlWI anagerRefe rence 



+theNtfSubscriber 



relation-ntfSubscriber-ntfSubscrption 



«hformationObjectClass» 
NtfSubscription 

+ ntfSubscriptionId 
1-theNtfSubscription + ntfSubscriptionState 

+ ntfTimeTick 

1..* + ntfTimeTickTimer 

+ ntfNotificationCategorySet 

+ ntfFilter 



5.2.2 Inheritance 

This subclause depicts the inheritance relationships that exists between information object classes. 



«lnformationObjectClass» 
ManagedGenericIRP 

(from TS 32.312) 



A 



«lnformationObjectClass» 
NotiiicationIRP 
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5.3 Information object classes definition 



5.3.1 



NtfSubscriber 



5.3.1.1 



Definition 



This information object represents a Subscriber from a notification IRP perspective : a subscriber is fully identified by a 
manager reference. An IRPManager using multiple managerReference attributes to subscribe will result in multiple 
NtfSubscriber instances. It inherits from IOC Top. 



5.3.1.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


ntfManagerReference 


% 


M 


- 


- 



5.3.2 NtfSubscription 



5.3.2.1 



Definition 



This information object represents a subscription that have been requested by an IRPManager and created. It inherits 
from IOC Top. 



5.3.2.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


ntfSubscriptionId 


+ 


M 


M 


- 


subscriptionState 


+ 


M 


M 


- 


ntfTimeJick 


+ 


M 


M 


- 


ntfTimeTickTimer 


% 


M 


- 


- 


ntfNotificationCategorySet 


+ 


M 


M 


- 


ntfFilter 


+ 


M 


M 


- 
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5.3.2.3 State diagram 

The diagram below depicts states that can be supported by a NtfSubscription. 



ntfJi m eJi ckTi m e r=0 / 
ntfSubscription is not 

deleted netSubscriptionStatus / 

/ \ ntfTimeTickJimer 
subscMte/ / \ re-initialised 

ntfTimeTickmrier | y 

initialised 



resumeSubscription 




-> 



notSuspended 




resumeSubscription 



suspenaSubscription 



suspended 



ntfTimeTickTimer=0 
/ ntfSubscription 

(and possibly 

ntfSubscriber) is 

deleted. 



unsubscribe / 

ntfSubscription (and 

possibly ntfSubscriber) is 

deleted 



NotificationIRP can lose the list of managerRef erence that identifies current IRPManagers under subscription. 
Under this condition, IRP Agent is incapable of sending events to the affected subscriber(s). 

This Notification IRP recommends that IRPManager should invoke the getSubscriptionStatus operation 
periodically to confirm that IRP Agent still has the IRPManager's reference in its list. In case getSubscriptionStatus 
returns the exception operation_failed, IRPManager should assume that IRP Agent has lost the IRPManager's reference. 

This IRP does not recommend the frequency IRPManager should use to invoke getSubscriptionStatus 
operation. 

5.3.3 NotificationIRP 
5.3.3.1 Definition 

This information object represents a notification IRP. It inherits from IOC managedGenericIRP. 



ETSI 



3GPP TS 32.302 version 7.0.0 Release 7 



13 



ETSI TS 132 302 V7.0.0 (2007-06) 



5.4 Information relationships definition 
5.4.1 relation-ntfSubscriber-ntfSubscription (M) 
5.4.1.1 Definition 

This relationship defines the relationship between a NtfSubscriber and its current subscriptions. 



5.4.1.2 



Roles 



Name 



Definition 



theNtfSubscriber 



This role represents the one who has subscribed. It can be played by instances of IOC NtfSubscriber 
This role represents the subscriptions which were made and not unsubscribed. It can be played by 
instances of IOC NtfSubscription 



theNtfSubscription 



5.4.1.3 



Constraints 



Name 


Definition 


lnv_notificationCategoriesAIIDistinct 


The notification categories contained in the ntfNotificationCategorySet attribute of 
NtfSubscription playing the role theNtfSubscription are all distinct from each other. 



5.4.2 relation-ntflRP-ntfSubscriber (M) 

5.4.2.1 Definition 

This relationship defines the relationship between the NotificationIRP and the current subscribers of notifications. 

5.4.2.2 Roles 



Name 


Definition 


theNtfSubscriber 


This role represents the entities to which IRPAgent will notify events. It is played by instances of IOC 
NtfSubscriber 


theNotificationIRP 


This role represents the NotificationIRP to which an IRPIVIanager has subscribed. It is played by 
instances of IOC NotificationIRP 



5.4.2.3 



Constraints 



Name 


Definition 


inv_uniquelVlanagerReference 


All NtfSubscriber involved in the subscriptionRegistration relationship with 
NotificationIRP are distinguished from each other by their ntflVlanagerReference 
Attribute. 
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5.5 



Information attributes definition 



This subclause defines the semantics of the Attributes used in Information Object Classes. 

5.5.1 Definitions and legal values 



Attribute Name 


Definition 


Legal Values 


ntfSubscriptionId 


It identifies uniquely a subscription 


N/A 


ntfSusbcriptionState 


It indicates the activation state of a subscription 


"suspended": the 
subscription is 
suspended 
"notSuspended": the 
subscription is active 


ntfTimeTicl< 


this Attribute represents the initial value of ntflimelickTimer. It is In unit 
of whole minute. This value defines a time window within which 
IRPManager intends to invoke getSubscriptionStatus (or 
subscribe) operation to confirm its subscription. A special value 
indicates infinity which is such that timer will never expire and IRPAgent 
needs other means to decide when to delete resources allocated to the 
IRPManager 


Integer greater or 
equal to 15, OR 
special infinite value 


ntfTimeTicl<Timer 


this Attribute represents the current value of a timer 


integer greater or 
equal to zero 


ntfNotificationCategorySet 


this Attribute represents a set of notification categories (see also 
Definition of notification category in subclause 3.1) 




ntfFilter 


this Attribute represents the filter of a subscription. The filter can be 

applied to parameters of notification header (see 

Notification IRPNotification interface) and to parameters of notifications 

defined as filterable in other IRP ISs. 

IRPAgent shall notify IRPManagers if the event satisfies the filter 

constraint. 




ntflVlanagerReference 


this Attribute contains the reference of a manager. It uniquely identifies 
a subscriber 





5.5.2 Constraints 

"ntfTimeTickTimer is lower or equal to ntfTimeTick" . 
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Interface Definition 



6.1 Class diagram representing interfaces 



«lnterface» 
SubscriptionStatusOperations 

+ getSubscriptionStatusO 



«lnterface» 
SubscriptionFilterOperations 

+ changeSubscriptionFilterO 



«lnterface» 
SubscriptionSuspendOperations 



+ suspendSubscriptionO 
+ resumeSubscriptionQ 




«may realize>^ 
«rTlay realize» 



«lnterface» 
IRPManagementOperations 



+ getNotificationCategoriesO 



«may realize» 



«realize» -^ 



«may realize» 

«lnformationObjectClass» 



«lnterface» 
Subscribe rManagement 



getSubscriptionldsQ 




<<may realize» 



«lnterface» 
NotificationlRPManagement 

+ subscribeQ 
+ unsubscribeQ 



NotificationIRP 



use 



0..1 



«lnterface» 
NotificationlRPNotification 



This «interface» defines the 
notificationHeader. Other «interface», 
such as AlarmlRPNotification, inherits from 
this «interface» and the 
notifications emitted by these other 
«interface» shall support the 
inherited notificationHeader. 



6.2 Generic rules 

Rule 1: Each operation with at least one input parameter supports a pre-condition valid_input_parameter which 

indicates that all input parameters shall be valid with regards to their information type. Additionally, each 
such operation supports an exception operation_failed_invalid_input_parameter which is raised when pre- 
condition valid_input_parameter is false. The exception has the same entry and exit state. 

Rule 2: Each operation with at least one optional input parameter supports a set of pre-conditions 

supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and 
the pre-condition indicates that the operation supports the named optional input parameter. Additionally, 
each such operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx 
which is raised when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the 
named optional input parameter is carrying information. The exception has the same entry and exit state. 
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Rule 3: Each operation shall support a generic exception operation_failed_intemal_problem which is raised when 
an internal problem occurs and that the operation cannot be completed. The exception has the same entry 
and exit state. 



6.3 notificationlRPManagement Interface (M) 
6.3.1 Operation subscribe (M) 



6.3.1.1 



Definition 



IRPManager invokes this operation to establish subscription to receive network events via notifications, under the filter 
constraint specified in this operation. 



6.3.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


managerReference 


M 


NtfSubscriber.ntflVlanagerReference 


It specifies the reference of IRPManager to which 
notifications shall be sent. 


timeTicl< 





NtfSubscription.ntfTimeTicl< 


It specifies the value of a timer hold by 
Notification IRP for the subject IRPManager. 
The value is in unit of whole minute. 
A special infinite value is assumed when parameter 
is absent or present but equal to zero. 


notification 
Categories 





SET OF (name of IRP, version of 
IRP) 


It identifies one or more Notification Category (see 
also Definition in subclause 3.1) 


filter 





NtfSubscription.ntf Filter 

Filter constraint grammar is SS 
dependent 


It specifies a filter constraint that IRPAgent shall use 
to filter notification of the category specified in 

notif icationCategories parameter. 

If this parameter is absent, then no filter constraint 

shall be applied. 



6.3.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


subscriptionid 


M 


NtfSubscription.ntfSubscriptionId 


It holds an unambiguous identity of this 
subscription. 


status 


M 


ENUM (OperationSucceeded, 

OperationFailedExistingSubscription, 

OperationFailed) 


If subscriptionCreated is true, status = 

OperationSuceeded. 

If operation_failed_existing_subscription is true, 

status = OperationFailedExistingSubscription 

If operationjailed is true, status = 

OperationFailed. 
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6.3.1.4 



Pre-condition 



notificationCategoriesNotAUSubscribed OR notificationCategoriesParameterAbsentAndNotAllSubscribed. 



Assertion Name 


Definition 


notificationCategoriesNotAIISubscribed 


At least one notificationCategory identified in the 
notificationCategories input parameter is supported by 
IRPAgent and is not a member of the 
ntfNotificationCategorySet attribute of an NtfSubscription 
which is involved in a subscription relationship with the 
NtfSubscriber identified by the managerReference input 
parameter. 


notificationCategoriesParameterAbsentAndNotAIISubscribed 


The notificationCategories input parameter is absent and 
at least one notificationCategory supported by IRPAgent is 
not a member of the ntfNotificationCategorySet attribute of 
an ntfSsubscription which is involved in a subscription 
relationship with the NtfSubscriber identified by the 
managerReference input parameter. 



6.3.1.5 



Post-condition 



subscriberPossiblyCreated AND subscriptionCreated. 



Assertion Name 


Definition 


subscriberPossiblyCreated 


An NtfSubscriber with a ntfManagerReference attribute equal to the value of the 
managerReference input parameter is involved in a subscriptionRegistration relationship 
with Notification IRP. 


subscriptionCreated 


An NtfSubscription has been created according to the following rules: 

• subscriptionState attribute value has been set to "notSuspended"; 

• ntfTimeTick attribute value has been set to the value of the timeTick input 
parameter if this value was higher or equal to 1 5, or set to 1 5 if this parameter 
value was between 1 and 1 5, or set to a special infinite value if the parameter value 
was lower or equal to or if parameter was absent; 

• ntfTimeTickTimer has been reset with the value of timeTick attribute; 

• ntfPilter attribute value has been set to the value of the filter input parameter if 
present; 

• NtfSubscription is involved in a subscription relationship with the NtfSubscriber 
identified by the managerReference input parameter; 

• attribute ntfNotificationCategorySet of NtfSubscription contains EITHER the 
notification categories identified by the notificationCategories input parameter that 
were not already contained in the ntfNotificationCategorySet attribute of other 
NtfSubscription of the same NtfSubscriber identified by the managerReference 
input parameter OR if notificationCategories input parameter is absent, all 
notification categories supported by IRPAgent that were not already contained in 
the ntfNotificationCategorySet attribute of other subscriptions of the same 
NtfSubscriber identified by the managerReference input parameter. 



6.3.1.6 



Exceptions 



Name 


Definition 


operation_failed_existing_subscription 


Condition: (notificationCategoriesNotAIISubscribed OR 
notificationCategoriesParameterAbsentAndNotAIISubscribed) not true 
Returned Information: The output parameter status 
Exit state: Entry State 


Operationfailed 


Condition: Post-condition is false 

Returned Information: The output parameter status 

Exit state: Entry State 
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6.3.2 Operation unsubscribe (M) 



6.3.2.1 



Definition 



The IRPManager invokes this operation to cancel subscriptions. The IRPManager can cancel one subscription made 
with a managerReference by providing the corresponding subscriptionid or all subscriptions made with the same 
managerReference by leaving the subscriptionid parameter absent. 



6.3.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


managerReference 


M 


NtfSubscriber.ntflVlanagerReference 


It specifies the reference of an IRPManager. 


subscriptionid 





NtfSubscription.ntfSubscriptionId 


It holds a subscriptionid carried as the output 
parameter in the subscribe operation. 



6.3.2.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM 

(OperationSucceeded, 

OperationFailed) 


If (subscriptionDeleted OR allSubscriptionDeleted) is true, 

status = OperationSucceeded. 

If operation failed is true, status = OperationFailed. 



6.3.2.4 Pre-condition 

validSubscriptionld&ManagerReference OR SubscriptionldAbsent&ValidManagerReference 



Assertion Name 


Definition 


validSubscriptionld&ManagerReference 


The NtfSubscription identified by subscriptionid input parameter is 
involved in a subscription relationship with the NtfSubscriber identified 
by the managerReference input parameter. 


SubscriptionldAbsent&ValidManagerReference 


The subscriptionid input parameter is absent and the NtfSubscriber 
identified by the managerReference input parameter exists. 



6.3.2.5 



Post-condition 



subscriptionDeleted OR allSubscriptionDeleted. 



Assertion Name 


Definition 


subscriptionDeleted 


The NtfSubscription identified by subscriptionid input parameter is no more involved in a 
subscription relationship with the NtfSubscriber identified by the managerReference input 
parameter and has been deleted. If this NtfSubscriber has no more NtfSubscription, it is deleted 
as well. 


allSubscriptionDeleted 


"n the case subscriptionid input parameter was absent, the NtfSubscriber identified by the 
managerReference input parameter is no more involved in any subscription relationship and is 
deleted, the corresponding NtfSubscription have been deleted as well. 



6.3.2.6 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false or post-condition is false 
Returned Information: The output parameter status 
Exit state: Entry State 
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6.4 subscriberManagement Interface (O) 

6.4.1 Operation getSubscriptionlds (M) 



6.4.1.1 



Definition 



IRPManager invokes this operation to get the values of all still valid (not unsubscribed or removed by IRP Agent) 
subscriptionlds assigned by NotificationIRP as result of previously subscribe operations performed by this 
IRPManager. 



6.4.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


managerReference 


M 


NtfSubscriber.ntfManagerReference 


It specifies the reference of IRPIVIanager tliat requests 
the set of identifiers of active subscriptions related to 
this IRPManager. 



6.4.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


subscriptionldSet 


M 


SET OF NtfSubscription.ntfSubscriptionId 
where NtfSubscription is involved in a 
subscription relationship with the 
NtfSubscriber identified by the 
managerReference input parameter 


It holds a set of the subscriptionid, each 
assigned as output parameter in previous 
subscribe operations invoked by the current 
IRPManager. This value should contain no 
information if the IRPManager did not yet 
subscribed to that System or System lost all 
subscription related information. 


status 


M 


ENUM (Operation succeeded, Operation 
failed) 


If validSubscriptionldSet is true, status = 

OperationSuceeded. 

If operationjailed is true, status = 

OperationFailed. 



6.4.1.4 Pre-condition 

validManagerReference. 



Assertion Name 


Definition 


validManagerReference 


The NtfSubscriber identified by the managerReference input parameter exists. 



6.4.1.5 

None specific 

6.4.1.6 



Post-condition 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false 

Returned Information: The output parameter status 

Exit state: Entry State 
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6.5 subscriptionStatusOperations Interface (O) 
6.5.1 Operation getSubscriptionStatus (M) 



6.5.1.1 



Definition 



IRPManager invokes this operation to query the subscription status of a particular subscription. IRPManager can use 
getSubscriptionStatus operation to know about the filter constraint in effect, the state of subscription (i.e. if subscription 
is suspended/inactive or resumed/active), the timeTick value that may be set at subscribe invocation time and the 
notificationCategory currently in used in the subscription. 



6.5.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


subscription Id 


M 


NtfSubscription.ntfSubscriptionId 


It holds the subscriptionid carried as the output 
parameter in the subscribe operation 



6.5.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


notification 
CategorySet 


C 


NtfSubscription.ntfNotificationCategorySet 


It identifies the notification Category(ies) 
supported in this subscription. 


filterlnEffect 





NtfSubscription.ntf Filter 


It contains the filter constraint currently set. 


SubscriptionState 





NtfSubscription.ntfSubscriptionState 




timeTick 





NtfSubscription.ntfTimeTIck 


It carries the same value as the one in 
subscribe operation 


status 


M 


ENUM (Operation succeeded, Operation 
failed) 


If (timeTlcKReset) is true, status = 

OperationSucceeded. 

If operationjailed is true, status = 

OperationFailed. 



6.5.1.4 Pre-condition 

validSubscriptionld. 



Assertion Name 



Definition 



validSubscriptionld 



"the NtfSubscription identified by subscriptionid input parameter is involved in a subscription 
relationship" 



6.5.1.5 Post-condition 

timeXickReset 



Assertion Name 



Definition 



timeTickReset 



The ntfTimeTickTimer attribute of NtfSubscription identified as input parameter has been reset with 
the value of ntfTimeTick attribute of the same NtfSubscription. 



6.5.1.6 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false or post-condition is false 
Returned Information: The output parameter status 
Exit state: Entry State 
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6.6 subscriptionFilterOperations Interface (O) 
6.6.1 Operation changeSubscriptionFilter (M) 
6.6.1.1 Definition 

IRPManager invokes this operation to replace the present fiher constraint with a new one. 



6.6.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


subscription Id 


M 


NtfSubscription.ntfSubscriptionId 


It carries the subscriptionid carried as the 
output parameter in the subscribe operation. 


filter 


M 


NtfSubscription.ntfFilter 


It specifies a filter constraint 



6.6.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Operation succeeded, 
Operation failed) 


If filterUpdated is true, status = 

OperationSuceeded. 

If operationjailed is true, status = 

OperationFailed. 



6.6.1.4 Pre-condition 

validNtfSubscriptionld. 



Assertion Name 



Definition 



validNtfSubscriptionld 



The NtfSubscription identified by subscriptionid input parameter is involved in a subscription 
relationship. 



6.6.1.5 Post-condition 

filterUpdated. 



Assertion Name 


Definition 


filterUpdated 


The ntfFilter attribute value of the NtfSubscription identified by subscriptionid input parameter 
has been set to the value of the filter input parameter. 



6.6.1.6 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false or post-condition is false 
Returned Information: The output parameter status 
Exit state: Entry State 
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6.7 subscriptionSuspendOperations Interface (O) 

6.7.1 Operation suspendSubscription (M) 



6.7.1.1 



Definition 



IRPManager invokes this operation to request IRP Agent to stop emission of notifications. IRP Agent may lose 
notification(s) if subscription is suspended. 

6.7.1.2 Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


subscription Id 


M 


NtfSubscription.ntfSubscriptionId 


It carries the subscriptionid carried as the output 
parameter in the subscribe operation. 



6.7.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Operation 
succeeded, Operation failed) 


If subscriptionStateSuspended is true, status = 

OperationSuceeded. 

If operation failed is true, status = OperationFailed. 



6.7.1.4 Pre-condition 

validSubscriptionld. 



Assertion Name 



Definition 



validSubscriptionld 



The NtfSubscription identified by subscriptionid input parameter is involved in a subscription 
relationship. 



6.7.1.5 Post-condition 

subscriptionStateSuspended. 



Assertion Name 


Definition 


subscriptionStateSuspended 


Tne ntfSubscriptionState attribute value of the NtfSubscription identified by subscriptionid 
input parameter has been set to or kept as "suspended". 



6.7.1.6 



Exceptions 



Name 


Definition 


Operationjailed 


Condition: Pre-condition is false or post-condition is false 
Returned Information: The output parameter status 
Exit state: Entry State 
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6.7.2 Operation resumeSubscription (M) 



6.7.2.1 Definition 

IRPManager invokes this operation to request IRP Agent to resume emission of notifications. 



6.7.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


subscription Id 


M 


NtfSubscription.ntfSubscriptionId 


It carries the subscription Id carried as the output 
parameter in the subscribe operation. 



6.7.2.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Operation succeeded, 
Operation failed) 


If subscriptionStateNotSuspended is true, status = 

OperationSuceeded. 

If operation failed is true, status = OperationFailed. 



6.7.2.4 Pre-condition 

validSubscriptionld. 



Assertion Name 



Definition 



validSubscriptionld 



The NtfSubscription identified by subscriptionid input parameter is involved in a subscription 
relationship. 



6.7.2.5 Post-condition 

subscriptionStateNotSuspended. 



Assertion Name 


Definition 


subscriptionStateNotSuspended 


The ntfSubscriptionState attribute value of the NtfSubscription identified by 
subscriptionid input parameter has been set to or kept as "notSuspended". 



6.7.2.6 



Exceptions 



Name 


Definition 


Operationfailed 


Condition: Pre-condition is false or post-condition is false 
Returned Information: The output parameter status 
Exit state: Entry State 
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6.8 IRPManagementOperations Interface (O) 
6.8.1 Operation getNotificationCategories (M) 



6.8.1.1 



Definition 



IRPManager invokes this operation to query the categories of notification supported by IRP Agent. IRP Agent returns 
the list of categories of notification supported. Each category of notification defines the name and the version of the IRP 
specification. The Ust of category of notification returned shall only contain the name and version of the IRP 
specifications that actually have notifications defined. 

IRPManager does not need to be in subscription to invoke this operation. 



6.8.1.2 

None. 



Input parameters 



6.8.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


NotificationCategoryList 


M 


SET OF (name and version of IRP 
specification) wliere each IRP is contained 
by IRPAgent and the attribute 
notificationNameProfile of the 
ManagedGenericIRP is not empty. 




status 


M 


ENUIVI (Operation succeeded, Operation 
failed) 


OperationFailed only if 
operation_failed_internal_problem 



6.8.1.4 

None specific. 

6.8.1.5 

None specific. 

6.8.1.6 

None specific. 



Pre-condition 



Post-condition 



Exceptions 
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6.9 Notification I RPNotification Interface 

IRP Agent notifies the subscribed IRPManager that an event has occurred and that the event has satisfied the filter 
constraints used for this subscription. One event example is the notification defined in Alarm IRP: IS 

(3GPPTS 32.111-2 [1]). 

It should be possible to pack multiple notifications together for sending to NM. This provides more efficient use of data 
communication resources. In order to pack multiple notifications, an EM/NE configurable parameter defines the 
maximum number of notifications to be packed together. Additionally an EM/NE configurable parameter defines the 
maximum time delay before the notifications have to be sent. 

Under normal operations, an IRP Agent shall send, to each IRPManager, notifications in the same order they were 
generated, i.e. in the First-In, First-Out order. There shall not be any priority given to types of notifications. 

This interface doesn't define any specific notification but instead defines information that is commonly found in 
notifications defined by other IRPs. This information is called notificationHeader. Notification interfaces defined in 
other IRPs, such as Alarm IRP: IS (3GPP TS 32.1 1 1-2 [1]), shall inherit from this interface and define their 
notifications by: 

• Identifying and qualifying the Notification Header attributes for their use; 

• Specify additional attributes specific to their use. 

Despite the fact that the semantic of notifications is defined by other IRP ISs, it is notification IRP and not those IRP 
that is responsible for the emission of those notifications. 

The Notification Header is defined here below. 



£75/ 



3GPP TS 32.302 version 7.0.0 Release 7 



26 



ETSI TS 132 302 V7.0.0 (2007-06) 



Attribute 
Name 


Qualifier 


Comment 


objectClass 


M, Y 


It specifies tlie class name of the IOC. A network event has occurred in an instance of this 
class. 


objectlnstance 


M, Y 


It specifies the instance of the above IOC in which the network event occurred by carrying the 
Distinguished Name (DN) of this object instance. This object may or may not be identical to 
the object instance actually emitting the notification. 


notificationid 


0,N 


This is an identifier for the notification, which may be used to correlate notifications. The 

identifier of the notification shall be chosen to be unique across all notifications of a particular 

managed object throughout the time that correlation is significant, it uniquely identifies the 

notification from other notifications generated by the subject Information Object. 

If IRPManager receives notifications from one IRPAgent, IRPManager shall use the identifier 

of the notification and the objectlnstance to uniquely identify all received notifications. 

If IRPManager receives notifications from multiple IRPAgents and notifications of each 

Information Object are reported at most through one IRPAgent, IRPManager shall use the 

identifier of the notification and objectlnstance to uniquely identify all received 

notifications. 

If IRPManager receives notifications from multiple IRPAgents and notifications of one or more 

Information Objects are reported through two or more IRPAgents, IRPManager shall use the 

identifier of the notification together with objectlnstance and the identity of IRPAgent 

(systemDN), to uniquely identify all received notifications. If the information systemDN is 

absent, IRPManager needs other means, which are outside the scope of this IRP, to 

determine the identity of IRPAgent. 

How identifiers of notifications are re-used to correlate notifications is outside of the scope of 

this recommendation. 


eventTime 


M, Y 


It indicates the event occurrence time. The semantics of Generalised Time specified by ITU-T 
shall be used here. 


system DN 


C, Y 


The systemDN of that notification shall carry either (1) the IRPAgent instance containing that 
Interface IRP instance, or (2) the DN of that particular Interface IRP instance responsible for 
the emission of the notification. 

(1) If the IRPAgent Contains single (not multiple) Interface IRP instance of a particular class, 
then the systemDN of a notification may carry the DN of the IRPAgent or DN of the subject 
Interface IRP instance. 

(2) If the IRPAgent Contains multiple Interface IRP instances of the same class, then the 
systemDN of a notification shall carry the DN of a particular Interface IRP instance 
responsible for the emission of that notification. 

Example of item (2) above: 

• Alarm IRP:IS specifies notifyNewAlarm. If there are multiple AlarmiRP 

instances under one IRPAgent, then the systemDN of notifyNewAlarm shall be 
present and carry the DN of the AlarmiRP. 


notificationType 


M, Y 


The type of notification which is reported by the notification 
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Annex A (informative): 
Change history 



Change history 
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TSG# 
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CR 
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Cat 


Old 
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Jun2001 
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SP-010283 


-- 


-- 


Approved at TSG SA #12 and placed under Change Control 


-- 


2.0.0 


4.0.0 


Dec 2001 


S_14 


SP-010642 


0001 
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Remove ambiguity of the return information for getNotificationCategories() 
operation 


F 


4.0.0 


4.1.0 


Dec 2001 


S_14 


SP-010653 


0002 




Change from Mandatory to Conditional the qualifier of the output 
parameter 'NotificationCategorySet' of the operation 
'getSubscriptionStatus' 


C 


4.1.0 


5.0.0 


Mar 2002 


-- 


-- 


-- 


-- 


Cosmetics (changed styles on cover) 


-- 


5.0.0 


5.0.1 


Dec 2002 


-- 


-- 


-- 


-- 


Cosmetics 


-- 


5.0.1 


5.0.2 


Jun 2003 


S_20 


SP-030278 


0004 


— 


Correction of the description of the objectClass and objectlnstance 
parameter of the notification header 


A 


5.0.2 


5.1.0 


Mar 2004 


S 23 


SP-040118 


0005 


-- 


Update Ntf IRP IS using new Template and UML Repertoire 


F 


5.1.0 


6.0.0 


Dec 2004 


S 26 


SP-040793 


0007 


-- 


Add missing rules on how to construct the string NotificationCategory 


A 


6.0.0 


6.1.0 


Mar 2005 


S 27 


SP-050035 


0008 


-- 


Apply Generic System Context 


F 


6.1.0 


6.2.0 


Jun 2005 


-- 


-- 


-- 


-- 


Introduction update : added 32.305 new TS-family member 


-- 


6.2.0 


6.2.1 


Mar 2006 


SA 31 


SP-060089 


0009 


-- 


Correct the use/meaning of systemDN in notification header 


F 


6.2.1 


6.3.0 


Jun 2007 


SA_36 


- 


- 


- 


Automatic upgrade to Rel-7 (no CR) at freeze of Rel-7. Deleted reference 
to CMIP SS, discontinued from R7 onwards. 


- 


6.3.0 


7.0.0 
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